.TH E1432_SET_TRIGGERS_PER_ARM 3 E1432
.SH NAME
.nf
e1432_set_triggers_per_arm \- Set number of triggers done for each arm
e1432_get_triggers_per_arm \- Get number of triggers done for each arm
.fi
.IX e1432_set_triggers_per_arm(3) 3
.IX e1432_get_triggers_per_arm(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_set_triggers_per_arm(E1432ID hw, SHORTSIZ16 ID,
                                      LONGSIZ32 n)
SHORTSIZ16 e1432_get_triggers_per_arm(E1432ID hw, SHORTSIZ16 ID,
                                      LONGSIZ32 *n)
.cE
.SH DESCRIPTION
When a measurement is running, an arm must take place before the E1432
is ready to receive a trigger.  This function is used to set the
number of triggers which are processed before the measurement loop
looks for another arm.

\fIe1432_get_triggers_per_arm\fR returns the current number of
triggers processed per arm, of a single channel or group of channels
\fIID\fR, in the memory location pointed to by \fIn\fR.

This parameter is a "global" parameter.  It applies to an entire E1432
module rather than to one of its channels.  The \fIID\fR parameter is
used only to identify which module the function applies to, and all
channels in that module will report the same value for this parameter.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIID\fR is either the ID of a group of channels that was obtained
with a call to \fIe1432_create_channel_group\fR, or the ID of a single
channel.

\fIn\fR specifies the number of triggers processed per arm.  If this
value is negative, an error occurs.  If this number is zero, then an
infinite number of triggers will be processed.  If this number is
positive, then that many triggers will be processed for each arm.
.SH "RESET VALUE"
After a reset, \fIn\fR is set to 1.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_set_auto_trigger, e1432_set_arm_mode
.ad
